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Preface 



This manual describes mdg, the Solboume Computer, Inc., standalone multiprocessor test 
controller for the Solboume systems. This manual contains four sections, as follows: 

Section 1 - Introduction 

This section introduces the Bootable/Standalone Multiprocessor Diagnostics 
program mdg. 

Section 2 - Getting Started with mdg 

This section explains how to begin using mdg. 

Section 3 - mdg Tests 

This section presents the tests currently available using mdg. 

Section 4 - Commands 

This section gives the user commands available when using mdg. 
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Section 1: Introduction 



1.1 Introduction 

mdg is a standalone test controller for use on Solboume multiprocessor systems. This program 
is used by design, manufacturing, and field engineering personnel to help in determining 
defective boards and in diagnosing these failures. The intended primary user of this program is 
the manufacturing organization. 

The software for mdg includes: 

• the mdg standalone test controller (mdg (1)) 

• test control commands 

• mdg tests 

1.2 Related Documentation 

Information that may be useful while using the mdg program is available in the following 
documentation: 

• Series4/600 Service Manual, Part number 101249-AA 

• Series4/600 Theory Manual Part number 1 01250- AA 

• Series4/500 Service Manual, Part number 102161-AA 

• Extended ROM Resident Diagnostics Manual Part number 101489- AB 

• System Power On Self Test Manual, Part number 101486- AB 
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Section 2: Getting Started with mdg 



2.1 Introduction 

This section gives step-by-step instructions and examples for getting started using mdg. 

In this section, commands you enter are given in boldface type. Command parameters for 
v^hich you substitute a value are given in italic, 

2.2 Invoking mdg 

The steps to follow the first time mdg is invoked are given below. 

The user must first bring the Solboume system to the ROM> prompt. If UNIX is running, it 



must be shutdown using the halt (1) command. . , . ^ i / 

1 . At the ROM> prompt, type: ^11'^''^^'' ' 

ROM>b sd. si ( ) /to^stand/xodg 

2. When mdg starts up, the following message is displayed: 



MDG - Multiprocessor Diagnostic Test Controller 
Version 1.1 September 25, 1989 
Copyright (c) 1989 Solboume Computer^ Inc , 



3. As mdg starts up, the following steps are undertaken by the MASTER processor: 

• Obtain the number of processors in the system and the results of power-up diagnostics 
from the diagnostic RAM. 

• Calculate the system-wide (shared memory) and CPU-specific (private memory) test 
limits. 

• Configure the memory configuration table with the number of memory boards in the 
system as well as their addressing range. 

• Configure the frame buffer configuration table with the values found during p>ower-up. 

• Initialize the VMEbus configuration table as empty. 

• Awake each SLAVE processor in the system that passed the power-up diagnostics. 
Each SLAVE processor will register with the MASTER processor in order for the 
MASTER to include it as part of the selected list of available system processors that 
mdg maintains. 

• By default, all available tests are selected and all the available processors are included 
for testing. 

4. Upon completion of the previous setup, mdg will display the following message: 
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CPU Configiiration: 




2 CPU boards: 




Slot# Power-Up-State 


Selected 


M 5 PASS 


YES 


6 PASS 


YES 



In this example, mdg found two processors in the system, both passed power-up 
diagnostics, and as a result both were selected for inclusion in the list of available 
processors. In the case of a processor failing power-up diagnostics, mdg will not include 
it as one of the SELECTED processors. However, mdg provides to the user the capability 
to attempt to include a processor that failed power-up diagnostics at any time. 

23 The Prompt 

The mdg prompt follows the following format: 



{ CPUs not included during test / CPUs included during test } <Pass limit> «> 



For example: In a system with two processors (in slots 5 and 6), with only the processor in slot 6 
to be included during testing, and the pass limit set to 1 the prompt to be displayed will be as 
follows: 



{ 5/6 } <1> => 



2.4 Entering Commands 

mdg commands and parameters are case insensitive and mdg accepts input only when the 
prompt is displayed. 

The rules for entering commands include: 

• In general more than one command can be entered in a single command line to the prompt 
at the same time. 

{ /5 6 ) <1> ="> tests 12 3 names on passlim between 5 r\in 

The above command line selects tests 1, 2, and 3, turns the printing of test names on, sets the 
pass limit to (no passlim), the between count is set to 5, and begins test execution with the 
run command. 

• Commands that process user input in an interactive mode, such as the vmeconf(l) and 
fbconfig (1 ), cause commands that follow on the command line to be ignored. 

• Conunands must be separated by white space{s), including tabs or spaces. (Senrdcolons are 
not recognized by mdg as spaces.) 
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• If any of the cx)mmand(s) entered return an error condition, all following commands are 
ignored and the prompt is redisplayed. 

• If a command is unrecognized by mdg, the following is displayed: 

Unknown command (command name) 

• All command lines are terminated by a Return. 

• Son\e commands may display additional error messages if numeric values are entered 
incorrectly or if the numeric values are not legal. These messages identify the value that is 
out of range, for example 

illegal address (value given) 

If an illegal value is given, additional information may be displayed that identifies the legal 
range of values. 

• Memory and I/O addresses and contents must be entered in hexidecimal format. Any value 
that has to do with hardware must also be entered in hexidecimal (e.g., register data, 
memory address, or memory data). 

• Counters and test numbers should be entered in decimal format (e.g., counts and limits). 

• The mdg help (1) conronand can be used any time the prompt is displayed. A summary of 
the command given as an argument to help will be displayed. 

2.5 Using mdg Commands 

Example usage of each mdg command is given in Section 4 of this manual. All commands can 
be used with any other commands. All the mdg commands are for test control. 

The test control commands are commands so categorized because they cause execution or alter 
the execution of the test programs. 

2*5,1 Test Control Commands 

The test control commands allow users to control tests run by the mdg debugger. The 
command names and their functions follow: 

• between (1) - Set or display between count 

• cozifig (1) - Display system processor configuration 

• continue (1) - Set or display continue on error flag 

• cpus (1) - Select or display processors included in tests 

' • cpulim (1) - Display or set processor specific memory test limits 

• deposit (1) - Deposit data at specified address 

• enrlim (1 ) - Set or display error limit 

• errors (1 ) - Display error count 

• examine (1) - Examine contents of memory 

• fbconfig (1) - Generates or display the frame buffer configuration 

• halt (1 ) - Remove processors from mdg environment 
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help (1) - Display this con\n\and list or information on a sj)ecific conunand 

limit (1 )- Display or set memory test limits 

loop (1) - Set or display loop on test flag 

master (1 ) - Display or set n\aster processor 

memconfig (1 ) - Display system memory configuration 

menu (1 ) - Display listing of available tests 

names (1 ) - Enable or disable printing of test names during test execution 

next (1 ) - Execute next selected test 

passes (1) - Display p)ass count 

passlim (1) - Set or display pass limit 

prompt (1) - Set or display prompt flags 

quiet (1) - Set or display error message enable flag 

quit (1) - Exit from mdg 

restart (1 ) - Restart execution of selected tests 

run (1 ) - Start execution of selected tests 

status (1 ) - Display or reset state of modes, flags, and counts 

tests (1 ) - Select or display tests to be executed 

timed) - Set or display print time flag and print current date and time 

vmeconf (1 )- Configure VMEbus devices 

wake (1) - Add processor to mdg environment 

2.6 Selecting Processors for Testing 

By default, when mdg is started all the processors that passed power-up diagnostics are 
selected for testing. Processors are selected/deselected for testing with the cpus (1) command. If 
the cpus command is entered without an argument, all the selected processors are displayed. 
For example: 



{ 5/6 } <1> => cpus 
selected cpus : 

6 
{ 5/6 } <1> => 



The processor selection can be modified at any time the prompt is displayed. For example: 
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{ 5/6 ) <1> => cpus all 
{ /5 6 } <1> «> cpus 
selected cpus : 

5 € 
{ /5 6 ) <1> -=> 



Processors that failed p)ower-up diagnostics, are not automatically included for testing, 
however by using the wake (1) command, it may be possible to include processors that failed. 
The ability for a processor to start mdg depends heavily on the type of failure it had during 
power-up. In that case, where a slave processor that is requested to start mdg, is unable to do 
so, the master processor will timeout after a given time period. 

For additional information on processor selection, see the cpus and wake commands in section 
4. 

2.7 Starting Test Execution 

When mdg is initially started, all the tests are selected. Tests are executed when the nin(l) 
command is entered at the command line. For example: 



{ /5 6 } <1> «=> tests nm 



If the tests command is entered without an argument, all the selected tests are displayed. For 
example: 



{ /5 6 } <1> => tests 

selected tests: 

12 3 



The test selection can be modified at any time the prompt is displayed. For example: 



{ /5 6 ) <1> => tests 1 
{ /5 6 ) <1> => tests 

selected tests : 

1 
{ /5 6 } <1> «> 



The menu command identifies the test names or their functions. For example 
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{ /5 


6 } <1> «> : 


menu 


Menu 


of installed test programs: 




Test 01: 


Atomic Load-Store Test 




Test 02: 


Memory Data RAM Test 




Test 03: 


Shared-Memory Pattern Test 




Test 04: 


Cache Block Alias Test 




Test 05: 


Floating Point Store Test 




Test 06: 


Cache Data Request Test 




Test 07: 


Cache Data Bus Pattern Test 




Test 08: 


Interrupt Test 


{ /5 


6 ) <1> => 





For additional infonnation on test execution, see the tests (1), run(l), and menu (1) conunands 
in Section 4. 

2.7.1 Variations of Test Execution 

This section discusses some of the basic variations that can be applied to test commands. There 
are other variations than those given here. 

Two results can occur during test execution. The test can pass or the test can fail. 

If the test passes, the user can do any of the followang: 

• Tell the controller how many iterations to run using the passlim (1 ) command 

• Controls whether the test names are printed using the names (1) command 

• The user can also stop test execution at any time by entering a Control-C CO 

Because of the difficulty controlling multi-asynchronous CPUs, mdg tests restart from the 
beginning when the loop(l) command is used. Therefore, even though the loop command is 
supported, it is not practical for setting up a scope loop. Instead, it is recommended that a logic 
analyzer be used for evaluating failures. 

If the test fails, the user can do any of the following: 

• If required, remove other processors from the test. 

• Skip to the next test in the selected sequence of tests using the next (1) command 

• Restart the entire sequence using the restart (1) command. 

2.8 Handling Test Failiires 

Several of the commands given in Section 4 that are used for test control can be used when test 
failures occur. In the following example, test 3 detects a failure and the loop and quiet 
' commands are used to set up a scof>e loop. 
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{ /5 6 


) 


<1> «=> tests 


4 run 
















Starting 


Test 


4 : Cache 


Block 


Alias 


Test 






















Tue 


Nov 


22 


14: 


58 


:04 


1988 


TEST 4 


ERROR: 


Tue Nov 


22 14 


58:10 


1988 












Data error at 


vaddr Ox 


08e000, 


r paddr OxffOBe 


000 








exp 


-= 


OxOSBeOOO 


















act 


■= 


0x0a21000 


















Fatal error. 


Test (s) 


terminated. 














{ /5 6 


} 


<1> ' 


=> 



















Note that test 3 has displayed its error message which identified the failing test case and 
returned to the prompt. If the user wishes to evaluate this test failure by setting up a logic 
analyzer, the sequence of commands shown in the following illustration may be entered. 



1/56} <1> ==> run 

Starting Test 4: Cache Block Alias Test 

Tue Nov 22 14:58:04 1988 
TEST 4 ERROR: Tue Nov 22 14:59:25 1988 
Data error at vaddr 0x08e000, paddr OxffOSeOOO 

exp = 0x058e000 

act = 0x0a21000 

Fatal error. Test(s) terminated. 
{ /5 6 } <1> => 



Note that test 3 has been re-executed and has redisplayed the same error message. This 
suggests the presence of a solid failure. To speed up the loop and avoid having to reenter the 
run command, the sequence of commands in the following illustration may be entered. 



{ /5 6 } <1> => passlim names off rain 
(Only pass and error count messages are displayed.) 



A Control-C must be entered to halt the program and return to the prompt. 
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2.9 Removing and Adding Processors 

It may be desirable in many ocassions to completely remove a processor from mdg. The halt (1) 
connmand provides a mechanism to do this. The effect of the halt command is to put the target 
processor in an idle loop at the ROM level. 



ii if ist NOTE i> A A 

If the target processor happens to be the master processor, it will 
first tell all of the available processors to exit mdg, and then it 
will exit from mdg itself. 

In the other hand, the wake command provides the user with the ability to tell a processor, 
which is idle at the ROM level, to start mdg as as slave processor and be part of the mdg 
environment. 

See the config (1 ), halt, and wake commands in Section 4 for additional information. 

2.10 Exiting mdg 

To exit mdg use the quit (1) command. 
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Section 3: mdg Tests 



3.1 Introduction 

This section explains the functionality of the tests shipped by Solboume Computer for use with 
the mdg (1 ) debugger. These tests include: 

1 . Atomic Load-Store Test 

2. Memory Data RAM Test 

3. Shared-Memory Pattern Test 

4. Cache Block Alias Test 

5. Floating Point Store Test 

6. Cache Data Request Test 

7. Cache Data Bus Pattern Test 

8. Interrupt Test 

i T> li- NOTE Ti A i> 

Error messages from one test are not valid, if failures have 
occurred during previous tests. The errors from a test must be 
corrected before advancing to the next test. 



3-2 Test 01: Atomic Load-Store Test 

This test verifies the logic related to atomic load-store unsigned byte instructions by having all 
processors involved in the test attempt to access and own a resource (byte) in memory for a 
predetermined number of iterations. 

In a multiprocessor system, two or more processors executing atomic load-store instructions 
addressing the same byte simultaneously are guaranteed to execute them in some serial order. 

Each processor attempts to lock this resource and assign a unique ownership identification (its 
slot number) to the locked resource. Upon sucessfully locking the given byte, the processor will 
assign its unique identification to this lock. Other processors should not be able to lock this byte 
until it has been unlocked by this processor. 

If after attempting to lock this byte, a processor finds that it is its owner but the identification 
pattern is not its pattern, an error condition is detected and rep>orted. For example: 
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Bad 


contents of 


lock 




exp 


= 0x03 






act 


- 0x05 





Upon test initialization, the master processor insures that all involved processors register in 
order to proceed vdth the test. If for some reason a processor is unable to register to the master 
processor, the master reports this as an error condition as follows: 



Processor does not register 
Processor = 5 



If the prompt flag for this test is set, the test prints out messages indicating the status of the test 
(how^ever this may slow down execution). 

3.3 Test 02: Memory Data RAM Test 

This test is sinnilar the the Memory Data RAM Test in dg except that each installed cpu card 
accesses only a f>ortion of each memory block. The test performs a movin inverse test algorithm 
but "shares" each tested memory block with all other installed processors. 

An example of a Data RAM Test failure follows: 



Error occurred in data RAM memory test 

Error code « OxeO Virtual addr - 0x00800000 Physical addr - OxOOeaOOOO 

Board slot = 2 

A data failure was found in the second read on the reverse pass 

exp - 0x55555555 

act = 0x5555555d 

xor = 0x00000008 



3.4 Test 03: Shared-Memory Pattern Test 

This test verifies basic cache consistency by having all processors involved in the test work in 
sequence during access to the same block of memory in FF space. 

During test initialization, the master processor assigns each processor a unique pattern that 
each processor writes to memory after waiting for another processor to write its pattern. In this 
manner, the entire block of memory is addressed and results in an environment upon where 
' each processor is constantly validating/invalidating its cache. 

If after a predetermined number of retries, a processor fails to match the expected pattern from 
memory, an error condition is detected and reported. For example: 
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Expected pattern not matched 
Retries = 2000 
Address = OxffOc02eO 
exp « 0x04 
act = 0x01 



Up)on test initialization, the nnaster processor insures that all involved processors register in 
order to proceed with the test. If for some reason a processor is unable to register to the master 
processor, the nrkaster reports this as an error condition as follows: 



Processor does not register 
Processor = 5 



If the prompt flag for this test is set, the test prints out messages indicating the status of the test 
(however this may slow down execution). 

3-5 Test 04: Cache Block Alias Test 

This test verifies that the cache tags will reference the correct entry in the cache rams. It verifies 
that a reference to the same physical location through different virtual addresses works 
differently. 

In a multiprocessor environment, this test performs a series of memory page write and reads in 
which all physical page addresses from XXXXOOOY to XXXXeOOY (hex) are written and read 
using all combinations of virtual page addresses from XXXXOOOY to XXXXeOOY including FF 
space addresses. Each processor involved in this test will have a different starting base address 
from the other processors (Y). 

For Series4 A write to a physical block using a virtual block address creates a unique 

physical-to-virtual mapping within the MMU. When the physical block is 
accessed using a different virtual address, the MMU must break the existing 
physical-to-virtual mapping, write the data block to its physical location in 
memory, and re-read it into the cache at the new virtual index. This creates 
the new physical-to-virtual mapping. 

This test insures that the MMU logic which detects the purge condition is 
operational and that the data (unique for each processor and for each 
physical page) is correctly transferred between the cache and the memory 
system among all the processors. 

For SeriesS Since the SeriesS processor does not have a virtual /physical cache this test 

simply exercises the TLB and cache. 

Possible error message: 
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Data error at vaddr 0x8e000, paddr OxffOSeOOO 
exp = 0x058e000 
act = OxOa21000 



Upon test initialization, the master processor insures that all involved processors register in 
order to proceed with the test. If for some reason a processor is unable to register to the master 
processor, the master will report this as an error condition as follows: 



Processor does not register 
Processor = 5 



If the prompt flag for this test is set, the test prints out status messages that indicate which 
physical and logical addresses are being used (however this slows down execution). 

3.6 Test 05: Floating Point Store Test 

This test is executed on all installed processors and is designed to exerdse Kbus cache 
consistency protocols when each processor's floating p)oint unit is busy doing store operations 
to its cache. 

Each active processor is given a unique 64 Kbyte region of memory by the master processor. 
This 64 Kbyte region is then divided into two 32 Kbyte regions by each processor. Each 
processor then tags the first 32 Kbyte region with the floating point representation of its BID 
pattern and the integer representation of its BID pattern into the second 32 Kbyte region. Each 
processor, then begins a loop in which it alternates between writing its own memory regions 
and verifying the two regions for all other processors. 

An example error message is show below: 



Data 


error in non-FE 


> store region 


of CPU in slot 


2 


FP 


store region = 


Oxff 800000 : Oxf f 807f f f 




non 


-FP store region = 0xff808000 


:0xff80ffff 




fai 


ling address = 


Oxff807002 






exp 


= 0x22222222 








act 


= 0x20222222 









3.7 Test 06: Cache Data Request Test 

- This test is executed on all installed processors and is designed to exerdse each processors 
ability to supply data in response to a Kbus data request (cacheable read) while busily 
performing cache/memory operations. 

Each processor begins by initializing memory with a sequence of patterns. 32-byte memory 
blocks are allocated to each processor (modulo the number of processors) with each memory 
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block containing a unique data pattern for the processor it is allocated to. The data pattern 
consists of an address tag in words 0, 2, 4 and 6 of the memory block and the BID of the 
processors which owns the memory block distributed across each nibble of words 1 and 5. 
Words 3 and 7 are initialized with the complement of the pattern in words 1 and 5. 

After memory has been initialized by all the processors, each processor gets synchronized with 
the other processors and begins to read and check each the contents of the other processor's 
caches for the correct data. This creates the desired kbus data request traffic. 

An example error message is show below: 



Data error detected by cpu X 
block address = Oxbbbbbbbb 
word address = Oxwwwwwwww 
exp = Oxeeeeeeee 
act = Oxaaaaaaaa 
block contents: 

11111111 22222222 

33333333 44444444 

55555555 66666666 

77777777 88888888 
Data belonged to cpu Y 



3.8 Test 07: Cache Data Bus Pattern Test 

This test is similar to the Cache Data Request Test except that when each processor reads data 
from another processors cache, a dirty cache block must first be flushed from the cache of the 
processor initiating the data request. 

Each processor begins by initializing its allocated memory segment (64 Kbytes for Series4, 128 
Kbytes for SeriesS) with alternating walking ones and walking zeroes patterns in successive 
cache lines. The memory segments allocated for each processor are equal in size to the cache 
size and segments are contiguous within the physical address space. This is done so that blocks 
within the cache of one processor must be flushed out to memory when the corresponding 
block within the cache of another processor is read. 

After memory has been initialized by all the processors, each processor gets synchronized with 
the other processors and reads the contents of the other processor's caches. The data read is not 
checked. The read operations cause data within the processor performing the read to be flushed 
out to memory. When all blocks from the other processors cache have been read, ECC is 
enabled and the original data which was flushed out to memory is re-read and checked to be 
correct. 

If the test fails, one of the following error messages will be displayed: 



Data fault occurred accessing block at address Oxaaaaaaaa 
FVAR = Oxbbbbbbbb 



This indicates that a data fault exception occurred when the cpu accessed address "Oxaaaaaaaa" 



mdg Tests 3-5 



Solbotinve Confidential Information - Do Not Distribute 



ECCS fault occurred accessing block at address Oxaaaaaaaa 
FPAR - Oxbbbbbbbb 
FES = Oxcc 



This indicates that cin ECC single bit exception occurred when the cpu accessed the cache block 
at address "Oxaaaaaaaa" 



Data error occurred at address Oxaaaaaaaa 
Pass N 

exp = Oxeeeeeeee 
act = Oxaaaaaaaa 
block contents: 

11111111 22222222 

33333333 44444444 

55555555 66666666 

77777777 88888888 



This indicates that the cpu read incorrect data at the specified address. Tass" indicates how 
many rej>etitions were completed when the error occurred. 

3.9 Test 08: Interrupt Test 

This test verifies that each processor can send directed interrupts to all other processors, and 
that each processor receives an interrupt from all others. 

For SeriesS, the global interrupt capability is verified in the same manner as for directed 
interrupts. 

Each processor starts by getting synchronized with all other processors, then all processors 
simultaneously begin sending interrupts to another processor. 10,000 iterations of the test are 
performed. 

The following error may occur: 



Never received directed interrupt from cpu in slot X 
passes completed = YY 



This indicates that all processors finished sending directed interrupts but one processor failed to 
receive it. 

If executed on a SeriesS machine, the following error could also occur: 
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Never received global interrupt from cpu in slot X 
passes completed = YY 



This indicates that all processors finished sending global interrupts but one processor failed to 
receive it. 
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Section 4: Commands 



4.1 Introduction 

This section offers printed copies of man pages for all commands associated with mdg(l). The 
commands are presented in the UNIX man page reference format. 

A summary of command usage is displayed on-line when mdg is running by typing: 

{ /5 6 ) <1> => ?. 

The following is a hsting of the mdg commands available in this section: 

between(l) 

config(l) 

continued) 

cpus(l) 

cpulim(l) 

deposit (1) 

errlim (1 ) 

errors (1) 

examined) 

fbconfigd) 

haltd) 

helpd) 

limit (1) 

loopd) 

master d) 

mdgd) 

memconfigd) 

menud) 

names (1) 

nextd) 

passes (1) 

passlimd) 

prompt (1) 

quietd) 

quitd) 

restart (1) 

nind) 

status d) 

timed) 

tests d) 

vmeconf (1) 

waked) 
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NAME 

between - Set or display between count 

SYNOPSIS 

between [ count ] 

DESCRIPTION 

between sets or displays the current setting of the between count, between suppresses 
printing test completed messages to the screen until count passes have completed. 

When the status (1) reset command is used, the between count is reset to 1. 

OPTION 

count Specifies the number of test passes that must be completed before a completion 
message is displayed. By default the between count is always set to 1 . 

EXAMPLE 

User input in the example is shown in boldface type. 

The following example illustrates how to set and redisplay the between count, 

{ /5 6 } <1> => between 4 
{ /5 6 } <1> => between 

Between count =4 
{ /5 6 ) <1> => 

SEE ALSO 

mdg(l), passlim (1), status (1) 
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NAME 

continue - Set or display continue on error flag 

SYNOPSIS 

continue [on I off] 

DESCRIPTION 

continue sets or displays the continue-on-error flag. If no parameters are specified, con- 
tinue displays the current setting of the continue-on-error flag. 

The continue flag commands tests to continue executing after a test failure occurs. Tests 
are designed to check the continue flag to determine if test execution should be halted 
(the default condition) or if the next test case should be executed. 

OPTIONS 

on Turns on the continue-on-error flag. 

off Turns off the continue-on-error flag. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example causes the current error message enable flag to be displayed. 

{ /5 6 ) <1> => continue 

continue = off 
{ /5 6 ) <1> => 

The following example illustrates how the continue flag is changed and redisplayed. 

{ /5 6 ) <1> «=> continue on 
{ /5 6 } <1> => continue 

continue = on 
{ /5 6 } <1> => 

SEE ALSO 

mdg(l), Status (1) 
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NAME 

cpus - Select or display processors included in testing 

SYNOPSIS 

cpus [ all I qyu ... I cpuxpu ... 1 

DESCRIPTION 

qjus select the processors that are to be tested by the selected tests. By default, all pro- 
cessors are selected for testing when the program is initialized. 

Single processors or a range of processors may be selected by specifying the processor 
numbers or range of processors number. 

OPTIONS 

all Select all the available processors, all can be sp)ecified at any time to reselect all 

processors. 

cpu Select specified cpu. If qpu is not specified, the cpus command displays the 

current processor selection. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example illustrates how to display the processor selection. 

{ /5 6 ) <1> => cpus 

selected cpus : 
5 6 
{ /5 6 ) <1> «> 

In the following example, processor 5 is selected and then displayed. 

{ /5 6 } <1> «> cpus 5 
{ 6/5 } <1> => cpus 
selected cpus: 

5 
{ 6/5 ) <1> => 

In the following example, processors 6 and 5 are selected and displayed. Note that pro- 
cessors may be selected in any order. 

{ 6/5 } <1> => cpus 6:5 
{ /5 6 } <1> «> cpus 
selected cpus: 
6 5 
{ /5 6 ) <1> «=> 

In the following example, all processors are selected and displayed. 

{ /5 6 } <1> => cpus all 
{ /5 6 } <1> => cpus 

selected cpus : 
5 6 
{ /5 6 } <1> => 
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SEE ALSO 

mdgd) 
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NAME 

cpulim - Display or set processor specific memory test limits 

SYNOPSIS 

cpulim [ cpu I [ low high I reset ] ] 

DESCRIPTION 

cpulim displays or sets the processor specific (private) memory test limits. By default, 
cpulim displays all memory limits for all of the processors in the system. 

cpulim is calculated using the amount of free memory and the number of processors in 
the system. 

Some test programs examine the private memory linnits to determine how much memory 
to test. 

OPTION 

reset Resets the limits back to the default settings. The default settings are deter- 
mined by the amount of free memory and the number of processors in the sys- 
tem. 

low high 

low is the first address and high is the last address to test, inclusive. 

EXAMPLE 

User input in the example is shown in boldface type. 

The following example displays the current limit settings for all the processors in the sys- 
tem. 

{ /5 6 } <1> => cpulim 

CPU Specific Memory limits: 

Slot# LOW HIGH 

5 dfOOO 4a3fff 

6 4C4000 82bfff 
{ /5 6 } <1> => 

The following example resets the memory limit to their default values. 

{ /5 6 } <1> => cpulim reset 
{ /5 6 } <1> => cpulim 

CPU Specific Memory limits: 

Slot# LOW HIGH 

5 dcOOO 4a3fff 

6 4a4000 86bfff 
{ /5 6 } <1> => 

The following example sets the memory limit for processor 5 to the range efOOO through 
400000 hex, inclusive. 

{ /5 6 ) <1> => cpulim 5 efOOO 400000 
{ /5 6 } <1> => cpulim 5 

CPU Specific Memory limits: 

Slot* LOW HIGH 
5 efOOO 400000 
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{ /5 € } <1> -=> 



SEE ALSO 

config(l), limit a),mdg(l) 
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NAME 

deposit - Deposit data at specified address 

SYNOPSIS 

deposit I -b I h I w ] [ addrjrange ] = value 

DESCRIPTION 

deposit writes data to an address or range of addresses. 

OPTIONS 

[•bihlw] 

Specifies the width of the data to be examined. 

-b - byte (8 bits) 

-h- half word (16 bits) 

-w - word (32 bits) 

If the width is not specified, a width of -b (1 byte) is assumed. 

addrjrange 

One of the following forms: 

oddr - the location fliir 

addr §couni - count locations starting from addr 

addrl uiddrZ - all locations from addrl to addrZ. 

rvalue Value to be written to the sf>edfied address. 

EXAMPLES 

The following example writes 32 bits of data (zero) to address fiDOOOOO hex. 

{ /5 6 ) <1> => deposit -w Oxff 000000=0 
{ /5 6 } <1> => 

SEE ALSO 

mdg(l), examine (1) 
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NAME 

errlim - Set or display error limit 

SYNOPSIS 

errlim [ limit ] 

DESCRIPTION 

errlim sets or displays the current setting of the test error limit. 

OPTION 

' limit Sp>edfies the number of test errors that can occur before test execution is halted. 
By default, the limit is set to zero (no error limit). However, the error limit may 
be changed by specifying a new limit value. The limit value must be entered in 
unsigned decimal format and be between and 2,147,483,647, inclusive. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example illustrates how to display the current error linnit. 

{ /5 6 } <1> => errlim 

Error limit = 
{ /5 6 ) <1> => 

The following example illustrates how to change and re-display the error linnit. 

{ /5 6 ) <1> => errlim 100 
i /5 6 } <1> => errlim 

Error limit = 100 
{ /5 6 ) <1> => 

SEE ALSO 

errors (1), mdg (1), status (1) 
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NAME 

errors - Display error count 

SYNOPSIS 

errors 

DESCRIPTION 

errors displays the number of test errors that have occurred since the last run(l) com- 
mand. 

EXAMPLE 

User input in the example is shown in boldface type. 

The following example illustrates how to display the error count. 

{ /5 € ) <1> => errors 

Total test errors = 
{ /5 6 ) <1> => 

SEE ALSO 

errlim (1), mdg (1), status (1) 
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NAME 

examine - Examine contents of memory 

SYNOPSIS 

examine [ -b I h I w ] [ addrjrange ] 

DESCRIPTION 

examine reads data from the sp>ecified address or addresses. 

OPTIONS 

[-b I h I w] 

Specifies the width of the data to be examined. 

-b- byte (8 bits) 

-h- half word (16 bits) 

-w - word (32 bits) 

addrjrange 

One of the following forms: 
addr - the location addr 

addr §couni - count locations starting from addr 
addrl uiddrl - all locations from addrl to addrl. 

If range is not specified, the address range used on the previous examine com- 
mand is used. 

EXAMPLES 

The following example shows how to examine a byte from location 17000000 hex. 

{ /5 6 } <1> => examine -b 0x17000000 
(0x17000000) : 0x3d 
{ /5 6 ) <1> => 

SEE ALSO 

mdg(l), deposit (1) 
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NAME 

fbconfig - displays the frame buffer configuration file 

SYNOPSIS 

fbconfig 

DESCRIPTION 

The frame buffier configuration is read from the diagnostic RAM when MDG is invoked. 

The board must be configured in descending slot order. 

EXAMPLE 

User input in the example is shown in boldface typ>e. 

{ /5 6 } <1> => fbconfig 

Frame Buffer Configuration: 

1 graphics board (s) : 

Slot 10 address Board Type Resolution 

1 alOOOOOO monochrome low 

Slot number of default board to test: 1 

{ /5 6 ) <1> => 

SEE ALSO 

mdg(l) 
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NAME 

halt - Remove processors from mdg environment 

SYNOPSIS 

halt [ all I q)u ... I cpuxpu ... ] 

DESCRIPTION 

halt removes the specified processors from the mdg environment. The effect of removing 
a processor from mdg is to put the specified processor in an idle loop at the ROM level, 
thus exiting from mdg. 

If the specified processor is the n\aster processor, the master processor will first tell all of 
the available processors in the system to exit mdg, and then it will exit mdg itself. 

OPTIONS 

all Halt all the available processors, all can be specified at any time to halt all pro- 

cessors. 

cpu Halt specified cpu, 

EXAMPLES 

User input in the examples is shov^rn in boldface type. 

In the following example, processor 6 is halted and removed from mdg. 

1/56} <1> => halt 6 
{ /5 ) <1> => 

In the following example, processors 6 and 5 are both halted, thus in effect both proces- 
sors exiting from mdg. Note that processors may be selected in any order. 

{ 6/5 } <1> => halt 6:5 
In the following example, all processors are halted. This results in both processors exit- 
ing from mdg. 

{ /5 6 } <1> => halt all 

SEE ALSO 

config (1), mdg (1), wake (1) 
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NAME 

help - Display command list or information on a specific command 

SYNOPSIS 

help [ command . . . ] 

DESCRIPTION 

The help conmiand with no arguments causes a list of command and conunand usages to 
be displayed. This is equivalent to the ? connmand. 

The help command with an argument causes the conmiand usage for the specified com- 
mand to be displayed. 

OPTIONS 

command 

name of command for which help is desired. 

EXAMPLE 

The following example causes the connmand usage for the tests command to be 
displayed: 

{ /5 6 ) <1> => help tests 

Usage: tests [ all I test ... I test:test ... ] 
{ /5 6 ) <1> => 

SEE ALSO 

mdg(l) 
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NAME 

limit - Display or set memory test limits 

SYNOPSIS 

limit [ reset I memname [ low high I reset ] ] 

DESCRIPTION 

limit displays or sets the memory test limits of the system. By default, limit displays all 
the memory limits. 

limit is set to the amount of installed memory for each memory devices in the system. 
Memory devices include physical shared memory, VMEbus address map memory, and 
VMEbus resident memory boards. 

The test programs examine the memory limits to determine how much memory to test. 

OPTION 

reset Resets the limits back to the default settings. The default settings are deter- 
mined by the amount of installed memory and the number of processors in the 

system. 

low high 

low is the first address and high is the last address to test, inclusive. 

EXAMPLE 

User input in the example is shown in boldface type. 

The following example displays the current limit settings for all the memory devices. 



{ /5 6 


} <1> => limit 






System 


Memory limits: 


LOW 


HIGH 




sysmem = 


87c000 


afffff 




vmemap = 


20 


7ff 




vmemem = 


3 


5ff 


{ /5 6 


) <1> => 







The following example resets the memory limits to their default values. 

{ /5 6 } <1> => limit reset 
{ /5 6 ) <1> => limit 



System Memory limits: 


LOW 


HIGH 


sysmem = 


86e000 


ffffff 


vmemap = 


20 


7ff 


vmemem = 





7ffff 


{ /5 6 } <1> => 







The following example sets the memory limits for physical shared memory to the range 
86e000 through cfffff hex and set the VMEbus address map limits to 20 through ff hex, 
inclusive. 
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{ /5 6 ) <1> -> limit mem 86e000 cfffff 
{ 75 6 ) <1> => limit vmemap 20 ff 
{ /5 6 ) <1> => limit 

System Memory limits : LOW HIGH 

sysmem = 86e000 cfffff 

vmemap « 20 ff 

vmemem =» 7ffff 

{ /5 6 ) <1> => 

The following example resets only the VMEbus address map limits to their default 
values. The physical shared memory values are not modified. 

{ /5 6 } <1> «> limit vmemap reset 
{ /5 6 } <1> => limit 

System Memory limits: LOW HIGH 

sysmem = 86e000 cfffff 

vmemap = 20 7ff 

vmemem = 7fff f 

{ /5 6 } <1> => 

SEE ALSO 

config(l),mdg(l) 
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NAME 

loop - Set or display loop on test flag 

SYNOPSIS 

loop [ on I ojf] 

DESCRIPTION 

loop sets or displays the loop on error flag. If no parameters are specified, loop displays 
the current setting of the loop flag. 

The loop flag commands tests to loop on the failing test case in the event a test error 
occurs. Tests are designed to halt when errors occur so that the loop command may be 
entered. 

OPTIONS 

on Turns on the loop flag. 

off Turns off the loop flag. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example causes the current loop flag do be displayed. 

{ /5 6 ) <1> => loop 

loop = off 
{ /5 6 } <1> => 

The following example illustrates how the loop flag is changed and re-displayed. 

{ /5 6 } <1> => loop on 
{ /5 6 } <1> => loop 

loop = on 
{ /5 6 ) <1> => 

SEE ALSO 

mdg(l), status (1) 
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NAME 

master - Set or display master processor 

SYNOPSIS 

masteilcpu] 

DESCRIPTION 

master sets or displays the current master q:)u of the system. The master cpw is the pro- 
cessor that is responsible for controlling all of mdg. This processor is in charge of moni- 
toring the other processors, as well as handling any requests for service initiated by the 
these. 

This command should be used when it is desired to have a sp>edfic processor control the 
mdg environment. 

OPTION 

cpu Select specified qyu to be the master. If qju is not specified, the master command 

displays the current master processor. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example illustrates how to display the current master processor. 

1/56} <1> => master 

Master CPU = 5 
{ /5 6 } <1> => 

The following example illustrates how to change and re-display the master processor. 

{ /5 6 } <1> => xnaster 6 
{ /5 6 ) <1> => xnaster 

Master CPU =6 
{ /5 6 } <1> => 

SEE ALSO 

mdg(l) 
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NAME 

mdg - description of the standalone multiprocessor diagnostic test controller 

SYNOPSIS 

mdg 

DESCRIPTION 

mdg is a standalone multiprocessor test controller. The test controller provides the com- 
mands necessary to randomly select and execute any of the available test programs on 
any or all of the processors in the system. The operator has control over test execution 
and can comnmnd test programs to loop on error or repeat execution indefinitely. 

The following is a list of the mdg commands with the shortest f)Ossible abbreviation in 
capital letters. Command names and abbreviations are not case sensitive. 

The acceptable conamands follow (bold, uppercase letters represent the abbreviated 
usage of the command name): 

? Display summary of indg commands 

between Set or display between count 

config Display system processor configuration 

continue 

Set or display continue on error flag 

opus Select or display processors included in test 

cpulim Set or display processor specific memory test limits 

deposit Deposit data at specified address 

errlim Set or display error limit 

errors Display error count 

examine Examine contents of memory 

fbconfig 

Displays the frame buffer configuration 

halt Remove processor from mdg environment 

help Display summary of xndg commands 

limit Display or set system memory test limits 

loop Set or display loop on test flag 

master Set or display master processor 

memconf ig 

Display system memory configuration 

menu Display listing of the available tests 

names Enable or disable printing of test names during test exe- 
cution 

next Execute next selected test 

passes Display pass count 

passlim Set or display pass limit 

prompt Set or display prompt flags 
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quiet Set or display error message enable flag 

quit Exit from mdg program 

restart Restart execution of selected tests 

run Start execution of selected tests 

status Display or reset state of modes^ flags and counts 

tests Select or display tests to be executed 

time Set or display print time flag and display current date 
and time 

vmeconf Configure VMEbus devices 

wake Add processor to mdg environment 
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NAME 

memconfig - Display memory configuration file 

SYNOPSIS 

memconfig 

DESCRIPTION 

memconfig displays the memory configuration. When MDG is invoked it creates a 
memory configuration table based on the memory configuration information saved in the 
diagnostic RAM during the px)wer-up self-tests. 

EXAMPLES 

User input in the examples is shown in boldface type. 

In the following example, memconfig is entered at the prompt. The contents of the 
memory configuration table is displayed. 

{ /5 6 ) <1> «> memconfig 

Memory Configuration: 

2 boards totaling 32 Mbytes 

Slot 1 16 Mbytes Base address = 00000000 

Slot 2 16 Mbytes Base address = 01000000 

{ /5 6 } <1> => 

SEE ALSO 

mdg(l) 
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NAME 

menu - Display listing of available tests 

SYNOPSIS 

menu 

DESCRIPTION 

menu lists the names of all available tests in the default order of execution, menu 
displays tests in the default order of execution. 

EXAMPLE 

User input in the example is shown in boldface type. 

The following example displays the list of installed tests. 

{ /5 6 } <1> => menu 

Menu of installed test programs: 

Test 01: Atomic Load-Store Test 
Test 02: Memory Data RAM Test 
Test 03: Shared-Memory Pattern Test 
Test 04: Cache Block Alias Test 
Test 05: Floating Point Store Test 
Test 06: Cache Data Request Test 
Test 07: Cache Data Bus Pattern Test 
Test 08: Interrupt Test 

{ /5 6 ) <1> => 



SEE ALSO 

mdg(l), tests (1) 
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NAME 

names - Enable or disable printing of test names during test execution 

SYNOPSIS 

names [ on I off] 

DESCRIPTION 

names enables or disables the printing of test names during test execution. 

OPTIONS 

on Enables the printing of the test names during test execution. This is the default 

setting. 

off Disables the printing of the test names during test execution. 

EXAMPLES 

User input in the examples is shown in boldface typ>e. 

The following example causes the state of the name flag to be displayed. 

{ /5 6 ) <1> => names 

names = on 
{ /5 6 ) <1> => 

The following example illustrates how the names flag is changed and redisplayed. 

{ /5 6 } <1> => names off 
{ /5 6 ) <1> => names 

names = off 
{ /5 6 } <1> => 

SEE ALSO 

mdg (1), status (1) 
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NAME 

next - Execute next selected test 

SYNOPSIS 
next 

DESCRIPTION 

next causes the test sequence to be continued, starting with the next selected test. It is 
used when a test halts on an error and the user wishes to continue test execution with the 
next test in the sequence. 

EXAMPLE 

User input in the example is shown in boldface type. 

In the following example run was entered to begin test execution. The current test selec- 
tion was executed until an error was encountered in test 1. next was entered to continue 
the test sequence starting with the next test in the sequence. 

{ /5 6 } <1> => run 

Starting Test 1: (testname) 
Test 1 error: (error message) 

{ /5 6 ] <1> => next 
Starting Test 2: {testname) 



Starting Test n: {testname) 

Tests completed: Passes = 1 Errors = 1 Tue Nov 22 14:58:04 1988 
{ /5 6 } <1> => 

SEE ALSO 

between (1 ), enlim (1), mdg (1 ), passlim (1 ), restart (1 ), run (1 ) 
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NAME 

passes - Display pass count 

SYNOPSIS 

passes 

DESCRIPTION 

passes displays the number of complete test passes that have made since the last run 
command. 

EXAMPLE 

User input in the example is shown in boldface type. 

The following example illustrates how to use the passes command. 

{ /5 6 } <1> => passes 

Total passes = 
i /5 6 } <1> -> 

SEE ALSO 

mdg{l),passlim(l) 
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NAME 

passlim - Set or display pass limit 

SYNOPSIS 

passlim [ limit ] 

DESCRIPTION 

passlim sets or displays the current setting of the test pass limit, passlim sp>edfies the 
number of test passes that can occur before test execution is halted. 

This command should be used when it is desired to execute numerous passes of the test 
sequence. 

OPTION 

limit Sets the number of test passes that will be run. By default, limit is set to one. 
Limit must be entered in unsigned decimal format in the range 0-to- 
2,147,483,647, inclusive. A limit of specifies that tests execute continuously 
until a Control-C is entered. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example illustrates how to display the current pass limit. 

{ /5 6 ) <1> => passlim 

Pass limit = 1 
{ /5 6 ) <1> => 

The following example illustrates how to change and re-display the pass limit. 

{ /5 6 } <1> «> passlim 
{ /5 6 ) <0> => passlim 

Pass limit = 
{ /5 6 } <0> => 

SEE ALSO 

mdg(l), passes (1) 
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NAME 

prompt - Set or display prompt flags 

SYNOPSIS 

prompt [ all I off I test test ... I testitest ... ] 

DESCRIPTION 

prompt sets or displays the prompt flag for each test program. The command allows the 
user to selectively alter the default behavior of the test programs by turning the flag for 
the sf>edfied tests on or off. 

Only a few of the mdg tests use the prompt flag. The behavior of the test depends on 
what the test is attempting to accomplish. In some case, if a test isn't prompted it does 
not execute. In others, it modifies the test algorithm or enables the printing of infonna- 
tional messages. 

Single tests or a range of tests may be prompted by specifying the test numbers or range 
of tests number. 

The menu (1) command indicates which tests examine their prompt flags. 

OPTIONS 

all Set prompt flags for all tests, all can be specified at any time to prompt all tests. 

off Turns prompt flags for all tests off. off can be specified at any time to turn off 

prompts for all tests. 

test Prompt specified test. If test is not SF>ecified, the prompt command displays the 

current status of the prompt flags. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example illustrates how to display the prompt flags. 

{ /5 6 ) <1> => proit5>t 
no prompted tests 

{ /5 6 ) <1> «=> prorc5>t all 

{ /5 6 } <1> => proit5?t 
prompted tests: 

12 3 

{ /5 6 } <1> => prompt off 

{ /5 6 } <1> => proir^Jt 2 3 

{ /5 € } <1> => proitpt 
prompted tests: 
2 3 

{ /5 6 ) <1> => 

SEE ALSO 

mdg (1 X menu (1 ), tests (1 ) 
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NAME 

quiet - Set or display error message enable flag 

SYNOPSIS 

quiet [on I off] 

DESCRIPTION 

quiet sets or displays the error message enable flag. If no parameters are specified, quiet 
displays the current setting of the flag. 

The error message enable flag prevents error messages from being displayed on test 
failures. This feature should be used to create the tightest possible loop when the loop 
flag is on. A Control-C must be entered to stop the loop and return to the prompt. 

OPTIONS 

on Turns on the quiet flag. 

off Turns off the quiet flag. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example causes the current error message enable flag to be displayed. 

{ /5 6 ) <1> => quiet 

quiet = off 
{ /5 6 ) <1> => 

The following example illustrates how the quiet flag is changed and redisplayed. 

{ /5 6 ) <1> => quiet on 
{ /5 6 ) <1> => quiet 

quiet = on 
{ /5 6 } <1> => 

SEE ALSO 

mdg(l), status (1) 
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NAME 

quit - Exit from mdg 

SYNOPSIS 
quit 

DESCRIPTION 

quit exits from the mdg debugger program and returns the user to the ROM> prompt. 

SEE ALSO 

mdg(l) 
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NAME 

restart - Restart execution of selected tests 

SYNOPSIS 

restart 

DESCRIPTION 

restart causes the current test(l) selection to be executed beginning with the first test 
current test selection. The major difference between restart and run (1) is that restart goes 
back to the first test in the sequence, while run continues execution with the next selected 
test. 

The number of times the test selection is executed depends on the value of the passlim (1) 
limit. 

EXAMPLE 

User input in the example is shown in boldface type. 

In the following example run was entered to begin test execution. The current test selec- 
tion were executed until an error was encountered in test 1. restart was entered to start 
the test sequence again from the beginning. 

{ /5 6 ) <1> => run 

Starting Test 1: (testname) 
Test 1 error: {error message) 

{ /5 6 ) <1> => restart 

Starting Test 1: (testname) 



Starting Test n: (testname) 

Tests completed: Passes - 1 Errors = Tue Nov 22 14:58:04 1988 
{ /5 6 } <1> => 

SEE ALSO 

mdg (1 ), next (1 ), passlim (1 ), run (1 ) 
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NAME 

run - Start execution of selected tests 

SYNOPSIS 
run 

DESCRIPTION 

run causes the current test(l) selection to be executed. The number of times the test 
selection is executed depends on the value of the passlim (1) limit. 

EXAMPLE 

User input in the example is shown in boldface type. 

In the following example run was entered to begin test execution. The current test selec- 
tion was executed once (passlim = 1) followed by a tests completed message. If passlim's 
limit is set to a value other than one, the complete test sequence would be repeatedly exe- 
cuted until limit is reached, at which time the program would return to the prompt. The 
test completed message is displayed after each pass. 

{ /5 6 } <1> => run 

Starting Test 1: {testname) 



Starting Test ni (testname) 

Tests completed: Passes = 1 Errors = Tue Nov 22 14:58:04 195 
{ /5 6 ) <1> => 

SEE ALSO 

mdg (1 ), next (1 ), passlim (1 ), restart (1 ) 
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NAME 

Status - Display or reset state of modes, flags, and counts 

SYNOPSIS 

status [ reset ] [flags] 

DESCRIPTION 

Status displays the current state of all modes, program flags, and counters, flags resets all 
the flags, which includes names, continue, loop, quiet, and xbuf. 

OPTION 

reset Resets the status of flags, counts, and limits to the default setting, reset also 
resets the test selection back to default values. 

flags Resets the status of flags to the default settings. 

EXAMPLE 

User input in the example is shown in boldface type. 

{ /5 6 } <1> «> status 

Tue Nov 22 12:45:20 1988 
Names = on 
Continue = off 
Loop = off 
i Quiet = off 

Time = off 

Pass count = Pass limit = 1 
Error count = Error limit = 
Between count = 1 

{ /5 6 ) <1> => 

SEE ALSO 

between (1), continued), ccc(l), errlim(l), errors (1), loop(l), mdg(l), names (1), 
passes (1), passlim (1), quiet (1), time (1) 
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NAME 

tests - Select or display tests to be executed 

SYNOPSIS 

tests [all I test test... I testitest ...] 

DESCRIPTION 

tests select the tests for execution by the run(l) connmand. By default, all tests are 
selected for execution when the program is initialized. 

Single tests or a range of tests may be selected by specifying the test numbers or range of 
tests number. 

OPTIONS 

all Execute all the tests, all can be specified at any time to reselect all tests. 

test Execute specified test. If test is not specified, the tests command displays the 
current test selection. 

EXAMPLES 

User input in the examples is shown in boldface type. 

The following example illustrates how to display the test selection. 

{ /5 6 ) <1> «> tests 

selected tests: 

12 3 

{ /5 6 } <1> => 

In the following example, tests 1 and 2 are selected and then displayed. 

{ /5 6 } <1> => tests 1 2 
{ /5 6 } <1> => tests 

selected tests : 

1 2 
{ /5 6 } <1> => 

In the following example, tests 3 through 1 are selected and displayed. Note that tests 
may be selected to run in any order. 

1/56} <1> => tests 3:1 
{ /5 6 ) <1> => tests 

selected tests: 

3 2 1 
{ /5 6 ) <1> => 

In the following example, all installed tests are selected and displayed. 

{ /5 6 ) <1> «> tests all 
{ /5 6 ) <1> => tests 
selected tests: 

12345678 
{ /5 6 ) <1> => 
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SEE ALSO 

mdg(l), next (1), restart (l),run(l) 
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NAME 

time - Set or display print time flag 

SYNOPSIS 

time [on I off] 

DESCRIPTION 

time sets or displays the print-time flag. If no parameters are specified, time displays the 
current setting of the print-time flag and the current time and data. The print-time flag 
controls whether the current time and date is printed when test names are displayed dur- 
ing test execution. The default state of the print-time flag is off (no time printed). If both 
the names flag and print-time flag are on, the time and date is printed on the line follow- 
ing the test name during test execution. 

OPTIONS 

on Turns on the print-time flag. 

off Turns off the print-time flag. 

EXAMPLES 

The following example causes the current print- time flag to be displayed: 

{ /5 6 } <1> => time 
Tue Nov 22 14:20:00 1988 

Time = off 
{ /5 6 } <1> => 

The following example illustrates how the print-time flag is changed and redisplayed. 

{ /5 6 ) <1> => time on 
{ /5 6 ) <1> «> time 
Tue Nov 22 14:20:00 1988 

Time = on 
{ /5 6 } <1> -=> 

SEE ALSO 

mdg (1 ), names (1 ), status (1 ) 
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NAME 

vmeconf - Configure VMEbus devices 

SYNOPSIS 

vmeconf 

DESCRIPTION 

vmeconf generates or displays the VMEbus configuration table. 

When mdg is invoked, it does not asks the user to generate a VMEbus configuration 
table. Therefore, if the user wishes to perform tests of the VMEbus chassis, they must 
first execute this command. 

vmeconf prompts for all user input. It accepts no options or arguments at the conunand 
line. 

Currently, vmeconf supports the Ciprico Rimfire, Excelan Ethernet, and Plessy RAM 
boards. 

EXAMPLE 

User input in the example is shown in boldface type. 

The following example shows how vmeconf is used to remove an Excelan Ethernet 
VMEbus board from the configuration, then how the program would be used to put the 
board back into the configuration table. 

{ /5 6 ) <1> => vmeconf 

VMEbus Configuration consists of four boards 

(0) Ciprico Rimfire 3500 VMEbus-to-SCSI 

Am = Ox2d Addr = 0x5000 Physaddr = 0x85ff5000 

(1) Excelan Ethernet 

Am = 0x3d Addr « OxdOOOOO Physaddr « 0x87d00000 

(2) Plessey RAM (512K> 

Am = OxSd Addr = 0x100000 Physaddr = 0x87100000 

Do you wish to change this configuration? (y/n) y 
Do you want the default configuration? (y/n) n 
Do you want to delete any entries? (y/n) y 
Entry number to delete (q to quit)? 1 
Entry number to delete (q to quit)? q 
Do you want to add any entries? (y/n) n 

(0) Ciprico Rimfire 3500 VMEbus-to-SCSI 

Am = 0x2d Addr = 0x5000 Physaddr = 0x85ff5000 

(2) Plessey RAM (512K) 

Am = 0x3d Addr = 0x100000 Physaddr =0x87100000 

Do you wish to change this configuration? (y/n) y 

Do you want the default configuration? (y/n) n 

Do you want to delete any entries? (y/n) n 

Do you want to add any entries? (y/n) y 

How many vme boards are to be added? (0-5) 1 

Enter information for board 1: 
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Valid vme board types are; 
: none 

1: Ciprico Rimfire 3500 VMEbus-to-SCSI 
2 : Excelan Ethernet 
3: Plessey RAM (512K) 
Type of board? 2 

Valid address modifiers are: 

9: extended user data access 

d: extended supervisor data access 

39: standard user data access 

3d: standard supervisor data access 

29: short user data access 

2d: short supervisor data access 
Address modifier? 3d 
Address? dODODO 

VMEbus Configuration consists of 3 boards 

(0) Ciprico Rimfire 3500 VMEbus-to-SCSI 

Am = Ox2d Addr « 0x5000 Physaddr = 0x85ff5000 

(1) Excelan Ethernet 

Am = 0x3d Addr = OxdOOOOO Physaddr = 0x87d00000 

(2) Plessey RAM (512K) 

Am = 0x3d Addr = 0x100000 Physaddr = 0x87100000 

Do you wish to change this configuration? (y/n) n 
( /5 6 ) <1> => 

SEE ALSO 

mdgd) 
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NAME 

wake - Add processor to mdg environment 

SYNOPSIS 

wake [ qju 1 

DESCRIPTION 

wake provides a method to tell a processor, which is idle at the ROM level, to start mdg 
as a slave processor. The specified processor must be recognized by the master as a valid 
processor in the system. 

OPTIONS 

qfu Add specified qju. The specified processor is told to start mdg as a slave proces- 

sor. 

EXAMPLES 

User input in the examples is shown in boldface type. 

In the following example, processor 6 is awaken and added to mdg. 

{ /5 6 } <1> => wake 6 
{ /5 6 } <1> => 

SEE ALSO 

config(l), halt (1), mdg (1) 
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NAME 

pdelstruct - delete structure 

SYNOPSIS 

#include '*phigs.h" 

void 

pdelstruct(struct_id) 

Pint structjd; /♦ structure identifier */ 

DESCRIPTION 

Call pdelstruct (3P) to delete a structure and its contents. 

OPERATING STATES 
(PHOP,*,*,*) 

EFFECT 

The Sf)edfied structure is deleted; its identifier, its contents and all references to it are 
removed from PHIGS. It is unposted from all workstations to which it is posted. In the 
event the sp>ecified structure is the open structure, the resulting functionality is 
equivalent to the following sequence: 

' CLOSE STRUCTURE 
DELETE STRUCTURE (structure identifier) 
OPEN STRUCTURE (structure identifier) 

If the sp>edfied structure does not exist, no action is taken. 

SEE ALSO 

pdelallstruct (3P), pdelstructnet (3P) 

DIAGNOSTICS 

002 Ignoring function, function requires state (PHOP,*,*,*) 
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